BREAKPOINT TRIGGERS

Overview

A number of component objects are provided which trigger a suspension of the simulation when a particular circuit condition arises. These are especially useful when combined with the single stepping facilities, since the circuit can be simulated normally until a particular condition arises, and then single stepped in order to see exactly what happens next.

The whole family lives in one place in the Library Browser, under the Debugging Tools category and the Breakpoint Triggers sub-category, so it is worth browsing that page to see what is there alongside the devices described below.

Setting Up a Hardware Breakpoint

A hardware breakpoint is a mechanism by which you can pause your simulation on a hardware condition (as opposed to in software). It is extremely useful when debugging your design, particularly when an asynchronous stimulus is applied to the circuit and you need to trace or analyse its effects on the circuit.

The simplest route is through a voltage probe, which carries the breakpoint as a property. Note that this works on a voltage probe only: a current probe has no breakpoint properties, so to break on a current you must place an RTIBREAK part instead.

To set up a hardware breakpoint:

  1. Place a voltage probe on the wire (or bus) on which you wish to trigger the breakpoint.

    A voltage probe placed on a wire on the schematic
  2. Right click on the probe and select Edit Properties from the context menu, or select the probe and press CTRL+E.

    The Edit Properties command on the context menu of a voltage probe
  3. In the Real Time Breakpoint group at the bottom of the dialogue form, select either Digital or Analog according to the net the probe is attached to, and specify a Trigger Value. For a digital net and a single wire this will be either 1 or 0 corresponding to a logic high or a logic low respectively, whereas for an analogue net it will be a voltage value. Arm at Time, in the same group, holds the breakpoint inactive until the simulation reaches the time you enter. The group starts out set to Disabled, which is also how you turn a breakpoint off again without losing the values you typed.

    The Real Time Breakpoint group on the Edit Voltage Probe dialogue form, set to Digital with a trigger value
  4. Click OK, then press Run on the Animation Control Panel (or F12) to run the simulation.

Edit Voltage Probe

Voltage Breakpoint Trigger - RTVBREAK

This device is available in 1 and 2 pinned forms, and triggers a breakpoint when the voltage at its single pin, or the voltage between its two pins, is greater than the specified value. You can couple this device to an arbitrary voltage source (AVS) to trigger a breakpoint on complex, formula-based conditions involving multiple voltages, currents and so on; the arbitrary current source (ACS) is its counterpart where the expression is best written in terms of a current.

Once the trigger voltage has been exceeded, the device does not re-trigger until the voltage has dropped below the trigger threshold and risen again.

Current Breakpoint Trigger - RTIBREAK

This device has two pins and triggers a breakpoint when the current flowing through it is greater than the specified value.

Once the trigger current has been exceeded, the device does not re-trigger until the current has dropped below the trigger threshold and risen again.

Digital Breakpoint Trigger - RTDBREAK

This device triggers a breakpoint when the binary value at its inputs equals the value assigned to the component. It ships in six widths, RTDBREAK_1, RTDBREAK_2, RTDBREAK_3, RTDBREAK_4, RTDBREAK_8 and RTDBREAK_16, alongside the single bit RTDBREAK itself, and you can make other sizes yourself if you need to. For example, specifying the value of an RTDBREAK_8 as 0x80 will cause it to trigger when D7 is high and D0 to D6 are low.

Once the trigger condition has arisen, the device does not re-trigger until a different input value has been seen.

Voltage Monitor - RTVMON

This device is available in 1 and 2 pinned forms, and acts when the input voltage falls outside the specified minimum or maximum values. By incorporating these objects into your simulator models, you can warn the end user when voltages within the model (for example the power supply voltage) exceed the specified operating limits.

What it does on a violation is set by the Trigger Action property, and the default is to raise a simulation error. The properties are:

Property Description
Input Name The name used for this input in the message the device produces. The default is Input Voltage.
Minimum Voltage The bottom of the permitted range.
Maximum Voltage The top of the permitted range.
Trigger Action What happens when the input leaves the range: Suspend suspends the simulation, Log records an informational message, Warn records a warning and Error raises a simulation error. Error is the default, so unless you change this property an out of range input is reported as an error rather than pausing the run.
Message Text Your own wording for the message. Left empty, the device reports the input name, the value seen and the range it was expected to stay within.

The Voltage Monitor selected in the Library Browser under Debugging Tools and Breakpoint Triggers

Selecting the Voltage Monitor from the Library Browser

Current Monitor - RTIMON

This device has two pins and acts when the current through the device falls outside the specified minimum or maximum values. By incorporating these objects into your simulator models, you can warn the end user when currents within the model (for example current passing through the device output terminals) exceed the specified operating limits.

Its properties are the same as those of the Voltage Monitor above, with Minimum Current and Maximum Current in place of the voltage limits, and Trigger Action again defaulting to Error.

The Current Monitor selected in the Library Browser under Debugging Tools and Breakpoint Triggers

Selecting the Current Monitor from the Library Browser

RTVMON and RTIMON are the RTVCHECK and RTICHECK simulator primitives packaged as schematic parts with their properties already laid out. Both primitives can also be placed in their own right if you are building a model of your own.

See Also:

Watchpoint Conditions

Using Breakpoints

Probes